home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-11 / fprotems.zip / PROWINDO.DOC < prev    next >
Text File  |  1993-01-04  |  5KB  |  92 lines
  1.  
  2.             PROWINDO.DOC
  3.             Author: Ellen Sander
  4.  
  5.             A UI2 Template
  6.             
  7.             Generates: Code for FoxPro user-defined windows.
  8.             
  9.             Requires:  Named boxes on the screen at generation time,
  10.                  with the word "Window" appearing somewhere in the box's
  11.                  description slot.
  12.             
  13.             Function library used: Prowindo.TLB
  14.             
  15.             Prowindo.TEM writes the code for windows you design in the
  16.             UI2 Editor.  To designate a UI2 box as a window, the word
  17.             "Window" must appear somewhere in the box's description
  18.             slot.  The box must also have a name entered in it's Name slot.
  19.             Do not tag the box as a  popup.
  20.             
  21.             To create a title for the window, type it into the top
  22.             border of the window.  No-border windows may not have a title.
  23.             Titles must be alphanumeric characters, square brackets [] or
  24.             immediately adjascent punctuation marks.  The function,
  25.             write_window_title() will look for the title
  26.             string in the top window border and generate the appropriate
  27.             code in the DEFINE WINDOW statement.  Anything else you may
  28.             type or paint on to the window border will be ignored.
  29.             Similarly, the template will ignore any graphics, text
  30.             notations or non-window boxes anywhere on the UI2 editor
  31.             screen outside of the windows, allowing you to visually
  32.             document your window sets.
  33.             
  34.             There are FoxPro windowing options supported by this
  35.             template that are not available as WYSIWYG objects from the
  36.             UI editor. They are:
  37.             
  38.             PANEL, SHADOW/NOSHADOW, GROW/NOGROW, FLOAT/NOFLOAT,
  39.             CLOSE/NOCLOSE, ZOOM/NOZOOM CLOSE/NOCLOSE
  40.             
  41.             These options are available to the template from the box's
  42.             slots as follows:
  43.             
  44.             1. PANEL
  45.             If you wish a PANEL border, type PANEL in the box's Slot 1.
  46.             
  47.             2. SHADOW/NOSHADOW, GROW/NOGROW, FLOAT/NOFLOAT,
  48.             CLOSE/NOCLOSE, ZOOM/NOZOOM,  CLOSE/NOCLOSE
  49.  
  50.             These options are supported by typing your choices in the
  51.             box's Slot 2.  Use the legal FoxPro syntax.
  52.             
  53.             The template will look for the new @...SAY...GET options in
  54.             the VALID slot for that field or variable.  After typing
  55.             your VALID expression (sans the word VALID, which the
  56.             template supplies-but see a note in the .tlb about this)
  57.             enter any complete, legally delimited ERROR, MESSAGE or WHEN
  58.             clause in the Valid Slot.  If the slot expression gets long,
  59.             you may type semi-colons where you want the line to break in
  60.             the code.
  61.             
  62.             It is suggested, but not mandatory, that the windows be the
  63.             only objects on the screen at generation time.  (The
  64.             template will will initialize any visible variables external
  65.             to the windows but will identify them as such in comments in
  66.             the generated code.) You may hide other objects from the UI2
  67.             Edit menu to generate the windows.
  68.             
  69.             COLORS:
  70.             Prowindo.TEM will write color code for the box border and
  71.             interior (color pairs 1 and 3) according to what is on the
  72.             UI2 screen you design.  If you define an enhanced color (for
  73.             input variables, pair 2) from the UI2 Vars menu, generated
  74.             code placing fields or variables inside windows will use
  75.             that color pair. Otherwise, fields and variables will take
  76.             on the second color pair defined in the FoxPro environmental
  77.             color scheme.  The color of the title of the active
  78.             (topmost) window at run-time is determined by the 4th color
  79.             pair in your FoxPro environmental setting.
  80.             
  81.             This version of Prowindo.TEM does no color checking inside
  82.             the window.  Any text in the window will appear in the
  83.             foreground color designated for the box when you created it.
  84.             Any painted colors will be ignored.
  85.  
  86.             More  complete instructions for using this template are
  87.             in the January, 1989 issue of DBMS Magazine.
  88.             However the code listings therein contain errors
  89.             which were editorially introduced.  At the time of
  90.             this writing the listings posted on their BBS
  91.             also contained these errors.
  92.